<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
<title>CollectionUtils (Apache Commons Collections 4.0 API)</title>
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
</head>
<body>
<script type="text/javascript"><!--
    if (location.href.indexOf('is-external=true') == -1) {
        parent.document.title="CollectionUtils (Apache Commons Collections 4.0 API)";
    }
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar_top">
<!--   -->
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
<!--   -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/CollectionUtils.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../org/apache/commons/collections4/ClosureUtils.html" title="class in org.apache.commons.collections4"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../../org/apache/commons/collections4/ComparatorUtils.html" title="class in org.apache.commons.collections4"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/commons/collections4/CollectionUtils.html" target="_top">Frames</a></li>
<li><a href="CollectionUtils.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
  allClassesLink = document.getElementById("allclasses_navbar_top");
  if(window==top) {
    allClassesLink.style.display = "block";
  }
  else {
    allClassesLink.style.display = "none";
  }
  //-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_top">
<!--   -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.commons.collections4</div>
<h2 title="Class CollectionUtils" class="title">Class CollectionUtils</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.apache.commons.collections4.CollectionUtils</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr>
<br>
<pre>public class <span class="strong">CollectionUtils</span>
extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Provides utility methods and decorators for <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> instances.
 <p>
 NOTE: From 4.0, method parameters will take <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> objects when possible.</div>
<dl><dt><span class="strong">Since:</span></dt>
  <dd>1.0</dd>
<dt><span class="strong">Version:</span></dt>
  <dd>$Id: CollectionUtils.java 1540639 2013-11-11 08:54:12Z tn $</dd></dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_summary">
<!--   -->
</a>
<h3>Field Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#EMPTY_COLLECTION">EMPTY_COLLECTION</a></strong></code>
<div class="block">An empty unmodifiable collection.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method_summary">
<!--   -->
</a>
<h3>Method Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#addAll(java.util.Collection, C[])">addAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
      C[]&nbsp;elements)</code>
<div class="block">Adds all elements in the array to the given collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#addAll(java.util.Collection, java.util.Enumeration)">addAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
      <a href="http://download.oracle.com/javase/6/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</a>&lt;? extends C&gt;&nbsp;enumeration)</code>
<div class="block">Adds all elements in the enumeration to the given collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#addAll(java.util.Collection, java.lang.Iterable)">addAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
      <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends C&gt;&nbsp;iterable)</code>
<div class="block">Adds all elements in the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to the given collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#addAll(java.util.Collection, java.util.Iterator)">addAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
      <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;? extends C&gt;&nbsp;iterator)</code>
<div class="block">Adds all elements in the iteration to the given collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#addIgnoreNull(java.util.Collection, T)">addIgnoreNull</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;&nbsp;collection,
             T&nbsp;object)</code>
<div class="block">Adds an element to the collection unless the element is null.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;int</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#cardinality(O, java.lang.Iterable)">cardinality</a></strong>(O&nbsp;obj,
           <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? super O&gt;&nbsp;coll)</code>
<div class="block">Returns the number of occurrences of <i>obj</i> in <i>coll</i>.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a>&lt;? super O&gt;&gt;&nbsp;<br><a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collate(java.lang.Iterable, java.lang.Iterable)">collate</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</code>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the natural ordering of the elements is retained.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a>&lt;? super O&gt;&gt;&nbsp;<br><a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collate(java.lang.Iterable, java.lang.Iterable, boolean)">collate</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
       boolean&nbsp;includeDuplicates)</code>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the natural ordering of the elements is retained.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collate(java.lang.Iterable, java.lang.Iterable, java.util.Comparator)">collate</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
       <a href="http://download.oracle.com/javase/6/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;? super O&gt;&nbsp;c)</code>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the ordering of the elements according to Comparator c is retained.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collate(java.lang.Iterable, java.lang.Iterable, java.util.Comparator, boolean)">collate</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
       <a href="http://download.oracle.com/javase/6/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;? super O&gt;&nbsp;c,
       boolean&nbsp;includeDuplicates)</code>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the ordering of the elements according to Comparator c is retained.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;I,O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;<br>R</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collect(java.lang.Iterable, org.apache.commons.collections4.Transformer, R)">collect</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends I&gt;&nbsp;inputCollection,
       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer,
       R&nbsp;outputCollection)</code>
<div class="block">Transforms all elements from inputCollection with the given transformer
 and adds them to the outputCollection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;I,O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collect(java.lang.Iterable, org.apache.commons.collections4.Transformer)">collect</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;I&gt;&nbsp;inputCollection,
       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer)</code>
<div class="block">Returns a new Collection consisting of the elements of inputCollection
 transformed by the given transformer.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;I,O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;<br>R</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collect(java.util.Iterator, org.apache.commons.collections4.Transformer, R)">collect</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;? extends I&gt;&nbsp;inputIterator,
       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer,
       R&nbsp;outputCollection)</code>
<div class="block">Transforms all elements from the inputIterator with the given transformer
 and adds them to the outputCollection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;I,O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#collect(java.util.Iterator, org.apache.commons.collections4.Transformer)">collect</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;I&gt;&nbsp;inputIterator,
       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer)</code>
<div class="block">Transforms all elements from the inputIterator with the given transformer
 and adds them to the outputCollection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#containsAll(java.util.Collection, java.util.Collection)">containsAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll1,
           <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll2)</code>
<div class="block">Returns <code>true</code> iff all elements of <code>coll2</code> are also contained
 in <code>coll1</code>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#containsAny(java.util.Collection, java.util.Collection)">containsAny</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll1,
           <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll2)</code>
<div class="block">Returns <code>true</code> iff at least one element is in both collections.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;int</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#countMatches(java.lang.Iterable, org.apache.commons.collections4.Predicate)">countMatches</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;C&gt;&nbsp;input,
            <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</code>
<div class="block">Counts the number of elements in the input collection that match the
 predicate.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#disjunction(java.lang.Iterable, java.lang.Iterable)">disjunction</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
           <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</code>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing the exclusive disjunction
 (symmetric difference) of the given <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#emptyCollection()">emptyCollection</a></strong>()</code>
<div class="block">Returns the immutable EMPTY_COLLECTION with generic type safety.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#emptyIfNull(java.util.Collection)">emptyIfNull</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;&nbsp;collection)</code>
<div class="block">Returns an immutable empty collection if the argument is <code>null</code>,
 or the argument itself otherwise.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#exists(java.lang.Iterable, org.apache.commons.collections4.Predicate)">exists</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;C&gt;&nbsp;input,
      <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</code>
<div class="block">Answers true if a predicate is true for at least one element of a
 collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;E&gt;&nbsp;E</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#extractSingleton(java.util.Collection)">extractSingleton</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection)</code>
<div class="block">Extract the lone element of the specified Collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#filter(java.lang.Iterable, org.apache.commons.collections4.Predicate)">filter</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
      <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super T&gt;&nbsp;predicate)</code>
<div class="block">Filter the collection by applying a Predicate to each element.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#filterInverse(java.lang.Iterable, org.apache.commons.collections4.Predicate)">filterInverse</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
             <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super T&gt;&nbsp;predicate)</code>
<div class="block">Filter the collection by applying a Predicate to each element.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;T</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#find(java.lang.Iterable, org.apache.commons.collections4.Predicate)">find</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
    <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super T&gt;&nbsp;predicate)</code>
<div class="block">Finds the first element in the given collection which matches the given predicate.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;<br>T</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#forAllButLastDo(java.lang.Iterable, C)">forAllButLastDo</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
               C&nbsp;closure)</code>
<div class="block">Executes the given closure on each but the last element in the collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;<br>T</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#forAllButLastDo(java.util.Iterator, C)">forAllButLastDo</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;T&gt;&nbsp;iterator,
               C&nbsp;closure)</code>
<div class="block">Executes the given closure on each but the last element in the collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;<br>C</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#forAllDo(java.lang.Iterable, C)">forAllDo</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
        C&nbsp;closure)</code>
<div class="block">Executes the given closure on each element in the collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;<br>C</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#forAllDo(java.util.Iterator, C)">forAllDo</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;T&gt;&nbsp;iterator,
        C&nbsp;closure)</code>
<div class="block">Executes the given closure on each element in the collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;T</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#get(java.lang.Iterable, int)">get</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;iterable,
   int&nbsp;index)</code>
<div class="block">Returns the <code>index</code>-th value in the <code>iterable</code>'s <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util"><code>Iterator</code></a>, throwing
 <code>IndexOutOfBoundsException</code> if there is no such element.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;T</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#get(java.util.Iterator, int)">get</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;T&gt;&nbsp;iterator,
   int&nbsp;index)</code>
<div class="block">Returns the <code>index</code>-th value in <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util"><code>Iterator</code></a>, throwing
 <code>IndexOutOfBoundsException</code> if there is no such element.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#get(java.util.Map, int)">get</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
   int&nbsp;index)</code>
<div class="block">Returns the <code>index</code>-th <code>Map.Entry</code> in the <code>map</code>'s <code>entrySet</code>,
 throwing <code>IndexOutOfBoundsException</code> if there is no such element.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#get(java.lang.Object, int)">get</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;object,
   int&nbsp;index)</code>
<div class="block">Returns the <code>index</code>-th value in <code>object</code>, throwing
 <code>IndexOutOfBoundsException</code> if there is no such element or
 <code>IllegalArgumentException</code> if <code>object</code> is not an
 instance of one of the supported types.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;O,<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a>&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#getCardinalityMap(java.lang.Iterable)">getCardinalityMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;coll)</code>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> mapping each unique element in the given
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> to an <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a> representing the number
 of occurrences of that element in the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#intersection(java.lang.Iterable, java.lang.Iterable)">intersection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
            <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</code>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing the intersection of the given
 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isEmpty(java.util.Collection)">isEmpty</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll)</code>
<div class="block">Null-safe check if the specified collection is empty.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isEqualCollection(java.util.Collection, java.util.Collection)">isEqualCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b)</code>
<div class="block">Returns <tt>true</tt> iff the given <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s contain
 exactly the same elements with exactly the same cardinalities.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isEqualCollection(java.util.Collection, java.util.Collection, org.apache.commons.collections4.Equator)">isEqualCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b,
                 <a href="../../../../org/apache/commons/collections4/Equator.html" title="interface in org.apache.commons.collections4">Equator</a>&lt;?&gt;&nbsp;equator)</code>
<div class="block">Returns <tt>true</tt> iff the given <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s contain
 exactly the same elements with exactly the same cardinalities.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isFull(java.util.Collection)">isFull</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;coll)</code>
<div class="block">Returns true if no more elements can be added to the Collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isNotEmpty(java.util.Collection)">isNotEmpty</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll)</code>
<div class="block">Null-safe check if the specified collection is not empty.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isProperSubCollection(java.util.Collection, java.util.Collection)">isProperSubCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                     <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b)</code>
<div class="block">Returns <tt>true</tt> iff <i>a</i> is a <i>proper</i> sub-collection of <i>b</i>,
 that is, iff the cardinality of <i>e</i> in <i>a</i> is less
 than or equal to the cardinality of <i>e</i> in <i>b</i>,
 for each element <i>e</i> in <i>a</i>, and there is at least one
 element <i>f</i> such that the cardinality of <i>f</i> in <i>b</i>
 is strictly greater than the cardinality of <i>f</i> in <i>a</i>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isSubCollection(java.util.Collection, java.util.Collection)">isSubCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
               <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b)</code>
<div class="block">Returns <tt>true</tt> iff <i>a</i> is a sub-collection of <i>b</i>,
 that is, iff the cardinality of <i>e</i> in <i>a</i> is less than or
 equal to the cardinality of <i>e</i> in <i>b</i>, for each element <i>e</i>
 in <i>a</i>.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#matchesAll(java.lang.Iterable, org.apache.commons.collections4.Predicate)">matchesAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;C&gt;&nbsp;input,
          <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</code>
<div class="block">Answers true if a predicate is true for every element of a
 collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#maxSize(java.util.Collection)">maxSize</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;coll)</code>
<div class="block">Get the maximum number of elements that the Collection can contain.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;E&gt;&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#permutations(java.util.Collection)">permutations</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection)</code>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> of all the permutations of the input collection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#predicatedCollection(java.util.Collection, org.apache.commons.collections4.Predicate)">predicatedCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                    <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</code>
<div class="block">Returns a predicated (validating) collection backed by the given collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#removeAll(java.util.Collection, java.util.Collection)">removeAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection,
         <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;remove)</code>
<div class="block">Removes the elements in <code>remove</code> from <code>collection</code>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#retainAll(java.util.Collection, java.util.Collection)">retainAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
         <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;retain)</code>
<div class="block">Returns a collection containing all the elements in <code>collection</code>
 that are also in <code>retain</code>.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#reverseArray(java.lang.Object[])">reverseArray</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]&nbsp;array)</code>
<div class="block">Reverses the order of the given array.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#select(java.lang.Iterable, org.apache.commons.collections4.Predicate)">select</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
      <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate)</code>
<div class="block">Selects all elements from input collection which match the given
 predicate into an output collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;<br>R</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#select(java.lang.Iterable, org.apache.commons.collections4.Predicate, R)">select</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
      <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate,
      R&nbsp;outputCollection)</code>
<div class="block">Selects all elements from input collection which match the given
 predicate and adds them to outputCollection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#selectRejected(java.lang.Iterable, org.apache.commons.collections4.Predicate)">selectRejected</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
              <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate)</code>
<div class="block">Selects all elements from inputCollection which don't match the given
 predicate into an output collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;<br>R</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#selectRejected(java.lang.Iterable, org.apache.commons.collections4.Predicate, R)">selectRejected</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
              <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate,
              R&nbsp;outputCollection)</code>
<div class="block">Selects all elements from inputCollection which don't match the given
 predicate and adds them to outputCollection.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#size(java.lang.Object)">size</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;object)</code>
<div class="block">Gets the size of the collection/iterator specified.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#sizeIsEmpty(java.lang.Object)">sizeIsEmpty</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;object)</code>
<div class="block">Checks if the specified collection/array/iterator is empty.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#subtract(java.lang.Iterable, java.lang.Iterable)">subtract</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
        <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</code>
<div class="block">Returns a new <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing <tt><i>a</i> - <i>b</i></tt>.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#subtract(java.lang.Iterable, java.lang.Iterable, org.apache.commons.collections4.Predicate)">subtract</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
        <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
        <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;O&gt;&nbsp;p)</code>
<div class="block">Returns a new <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing <i>a</i> minus a subset of
 <i>b</i>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#synchronizedCollection(java.util.Collection)">synchronizedCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection)</code>
<div class="block">Returns a synchronized collection backed by the given collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#transform(java.util.Collection, org.apache.commons.collections4.Transformer)">transform</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
         <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super C,? extends C&gt;&nbsp;transformer)</code>
<div class="block">Transform the collection by applying a Transformer to each element.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;E&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#transformingCollection(java.util.Collection, org.apache.commons.collections4.Transformer)">transformingCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection,
                      <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super E,? extends E&gt;&nbsp;transformer)</code>
<div class="block">Returns a transformed bag backed by the given collection.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#union(java.lang.Iterable, java.lang.Iterable)">union</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
     <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</code>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing the union of the given
 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#unmodifiableCollection(java.util.Collection)">unmodifiableCollection</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? extends C&gt;&nbsp;collection)</code>
<div class="block">Returns an unmodifiable collection backed by the given collection.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
<!--   -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_detail">
<!--   -->
</a>
<h3>Field Detail</h3>
<a name="EMPTY_COLLECTION">
<!--   -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>EMPTY_COLLECTION</h4>
<pre>public static final&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a> EMPTY_COLLECTION</pre>
<div class="block">An empty unmodifiable collection.
 The JDK provides empty Set and List implementations which could be used for
 this purpose. However they could be cast to Set or List which might be
 undesirable. This implementation only implements Collection.</div>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method_detail">
<!--   -->
</a>
<h3>Method Detail</h3>
<a name="emptyCollection()">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>emptyCollection</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;&nbsp;emptyCollection()</pre>
<div class="block">Returns the immutable EMPTY_COLLECTION with generic type safety.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the element type</dd>
<dt><span class="strong">Returns:</span></dt><dd>immutable empty collection</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#EMPTY_COLLECTION"><code>EMPTY_COLLECTION</code></a></dd></dl>
</li>
</ul>
<a name="emptyIfNull(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>emptyIfNull</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;&nbsp;emptyIfNull(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;&nbsp;collection)</pre>
<div class="block">Returns an immutable empty collection if the argument is <code>null</code>,
 or the argument itself otherwise.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the element type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection, possibly <code>null</code></dd>
<dt><span class="strong">Returns:</span></dt><dd>an empty collection if the argument is <code>null</code></dd></dl>
</li>
</ul>
<a name="union(java.lang.Iterable, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>union</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;union(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                      <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</pre>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing the union of the given
 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.
 <p>
 The cardinality of each element in the returned <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> will
 be equal to the maximum of the cardinality of that element in the two
 given <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the generic type that is able to represent the types contained
        in both input collections.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the union of the two collections</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#addAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.addAll(java.util.Collection&lt;? extends E&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="intersection(java.lang.Iterable, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>intersection</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;intersection(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                             <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</pre>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing the intersection of the given
 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.
 <p>
 The cardinality of each element in the returned <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> will
 be equal to the minimum of the cardinality of that element in the two
 given <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the generic type that is able to represent the types contained
        in both input collections.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the intersection of the two collections</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#retainAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.retainAll(java.util.Collection&lt;?&gt;)</code></a>, 
<a href="../../../../org/apache/commons/collections4/CollectionUtils.html#containsAny(java.util.Collection, java.util.Collection)"><code>containsAny(java.util.Collection&lt;?&gt;, java.util.Collection&lt;?&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="disjunction(java.lang.Iterable, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>disjunction</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;disjunction(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                            <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</pre>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing the exclusive disjunction
 (symmetric difference) of the given <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>s.
 <p>
 The cardinality of each element <i>e</i> in the returned
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> will be equal to
 <tt>max(cardinality(<i>e</i>,<i>a</i>),cardinality(<i>e</i>,<i>b</i>)) - min(cardinality(<i>e</i>,<i>a</i>),
 cardinality(<i>e</i>,<i>b</i>))</tt>.
 <p>
 This is equivalent to
 <tt><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#subtract(java.lang.Iterable, java.lang.Iterable)"><code>subtract</code></a>(<a href="../../../../org/apache/commons/collections4/CollectionUtils.html#union(java.lang.Iterable, java.lang.Iterable)"><code>union(a,b)</code></a>,<a href="../../../../org/apache/commons/collections4/CollectionUtils.html#intersection(java.lang.Iterable, java.lang.Iterable)"><code>intersection(a,b)</code></a>)</tt>
 or
 <tt><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#union(java.lang.Iterable, java.lang.Iterable)"><code>union</code></a>(<a href="../../../../org/apache/commons/collections4/CollectionUtils.html#subtract(java.lang.Iterable, java.lang.Iterable)"><code>subtract(a,b)</code></a>,<a href="../../../../org/apache/commons/collections4/CollectionUtils.html#subtract(java.lang.Iterable, java.lang.Iterable)"><code>subtract(b,a)</code></a>)</tt>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the generic type that is able to represent the types contained
        in both input collections.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the symmetric difference of the two collections</dd></dl>
</li>
</ul>
<a name="subtract(java.lang.Iterable, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>subtract</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;subtract(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                         <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</pre>
<div class="block">Returns a new <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing <tt><i>a</i> - <i>b</i></tt>.
 The cardinality of each element <i>e</i> in the returned <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>
 will be the cardinality of <i>e</i> in <i>a</i> minus the cardinality
 of <i>e</i> in <i>b</i>, or zero, whichever is greater.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the generic type that is able to represent the types contained
        in both input collections.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the collection to subtract from, must not be null</dd><dd><code>b</code> - the collection to subtract, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new collection with the results</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#removeAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.removeAll(java.util.Collection&lt;?&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="subtract(java.lang.Iterable, java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>subtract</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;subtract(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                         <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
                         <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;O&gt;&nbsp;p)</pre>
<div class="block">Returns a new <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> containing <i>a</i> minus a subset of
 <i>b</i>.  Only the elements of <i>b</i> that satisfy the predicate
 condition, <i>p</i> are subtracted from <i>a</i>.

 <p>The cardinality of each element <i>e</i> in the returned <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>
 that satisfies the predicate condition will be the cardinality of <i>e</i> in <i>a</i>
 minus the cardinality of <i>e</i> in <i>b</i>, or zero, whichever is greater.</p>
 <p>The cardinality of each element <i>e</i> in the returned <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> that does <b>not</b>
 satisfy the predicate condition will be equal to the cardinality of <i>e</i> in <i>a</i>.</p></div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the generic type that is able to represent the types contained
        in both input collections.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the collection to subtract from, must not be null</dd><dd><code>b</code> - the collection to subtract, must not be null</dd><dd><code>p</code> - the condition used to determine which elements of <i>b</i> are
        subtracted.</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new collection with the results</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#removeAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.removeAll(java.util.Collection&lt;?&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="containsAll(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>containsAll</h4>
<pre>public static&nbsp;boolean&nbsp;containsAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll1,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll2)</pre>
<div class="block">Returns <code>true</code> iff all elements of <code>coll2</code> are also contained
 in <code>coll1</code>. The cardinality of values in <code>coll2</code> is not taken into account,
 which is the same behavior as <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#containsAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.containsAll(Collection)</code></a>.
 <p>
 In other words, this method returns <code>true</code> iff the
 <a href="../../../../org/apache/commons/collections4/CollectionUtils.html#intersection(java.lang.Iterable, java.lang.Iterable)"><code>intersection(java.lang.Iterable&lt;? extends O&gt;, java.lang.Iterable&lt;? extends O&gt;)</code></a> of <i>coll1</i> and <i>coll2</i> has the same cardinality as
 the set of unique values from <code>coll2</code>. In case <code>coll2</code> is empty, <code>true</code>
 will be returned.
 <p>
 This method is intended as a replacement for <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#containsAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.containsAll(Collection)</code></a>
 with a guaranteed runtime complexity of <code>O(n + m)</code>. Depending on the type of
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> provided, this method will be much faster than calling
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#containsAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.containsAll(Collection)</code></a> instead, though this will come at the
 cost of an additional space complexity O(n).</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>coll1</code> - the first collection, must not be null</dd><dd><code>coll2</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> iff the intersection of the collections has the same cardinality
   as the set of unique elements from the second collection</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="containsAny(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>containsAny</h4>
<pre>public static&nbsp;boolean&nbsp;containsAny(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll1,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll2)</pre>
<div class="block">Returns <code>true</code> iff at least one element is in both collections.
 <p>
 In other words, this method returns <code>true</code> iff the
 <a href="../../../../org/apache/commons/collections4/CollectionUtils.html#intersection(java.lang.Iterable, java.lang.Iterable)"><code>intersection(java.lang.Iterable&lt;? extends O&gt;, java.lang.Iterable&lt;? extends O&gt;)</code></a> of <i>coll1</i> and <i>coll2</i> is not empty.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>coll1</code> - the first collection, must not be null</dd><dd><code>coll2</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> iff the intersection of the collections is non-empty</dd><dt><span class="strong">Since:</span></dt>
  <dd>2.1</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#intersection(java.lang.Iterable, java.lang.Iterable)"><code>intersection(java.lang.Iterable&lt;? extends O&gt;, java.lang.Iterable&lt;? extends O&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="getCardinalityMap(java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getCardinalityMap</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;O,<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a>&gt;&nbsp;getCardinalityMap(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;coll)</pre>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> mapping each unique element in the given
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> to an <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang"><code>Integer</code></a> representing the number
 of occurrences of that element in the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>.
 <p>
 Only those elements present in the collection will appear as
 keys in the map.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the type of object in the returned <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a>. This is a super type of <I>.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>coll</code> - the collection to get the cardinality map for, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the populated cardinality map</dd></dl>
</li>
</ul>
<a name="isSubCollection(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isSubCollection</h4>
<pre>public static&nbsp;boolean&nbsp;isSubCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                      <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b)</pre>
<div class="block">Returns <tt>true</tt> iff <i>a</i> is a sub-collection of <i>b</i>,
 that is, iff the cardinality of <i>e</i> in <i>a</i> is less than or
 equal to the cardinality of <i>e</i> in <i>b</i>, for each element <i>e</i>
 in <i>a</i>.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first (sub?) collection, must not be null</dd><dd><code>b</code> - the second (super?) collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> iff <i>a</i> is a sub-collection of <i>b</i></dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isProperSubCollection(java.util.Collection, java.util.Collection)"><code>isProperSubCollection(java.util.Collection&lt;?&gt;, java.util.Collection&lt;?&gt;)</code></a>, 
<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#containsAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.containsAll(java.util.Collection&lt;?&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="isProperSubCollection(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isProperSubCollection</h4>
<pre>public static&nbsp;boolean&nbsp;isProperSubCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                            <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b)</pre>
<div class="block">Returns <tt>true</tt> iff <i>a</i> is a <i>proper</i> sub-collection of <i>b</i>,
 that is, iff the cardinality of <i>e</i> in <i>a</i> is less
 than or equal to the cardinality of <i>e</i> in <i>b</i>,
 for each element <i>e</i> in <i>a</i>, and there is at least one
 element <i>f</i> such that the cardinality of <i>f</i> in <i>b</i>
 is strictly greater than the cardinality of <i>f</i> in <i>a</i>.
 <p>
 The implementation assumes
 <ul>
    <li><code>a.size()</code> and <code>b.size()</code> represent the
    total cardinality of <i>a</i> and <i>b</i>, resp. </li>
    <li><code>a.size() < Integer.MAXVALUE</code></li>
 </ul></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first (sub?) collection, must not be null</dd><dd><code>b</code> - the second (super?) collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> iff <i>a</i> is a <i>proper</i> sub-collection of <i>b</i></dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isSubCollection(java.util.Collection, java.util.Collection)"><code>isSubCollection(java.util.Collection&lt;?&gt;, java.util.Collection&lt;?&gt;)</code></a>, 
<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#containsAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.containsAll(java.util.Collection&lt;?&gt;)</code></a></dd></dl>
</li>
</ul>
<a name="isEqualCollection(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isEqualCollection</h4>
<pre>public static&nbsp;boolean&nbsp;isEqualCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                        <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b)</pre>
<div class="block">Returns <tt>true</tt> iff the given <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s contain
 exactly the same elements with exactly the same cardinalities.
 <p>
 That is, iff the cardinality of <i>e</i> in <i>a</i> is
 equal to the cardinality of <i>e</i> in <i>b</i>,
 for each element <i>e</i> in <i>a</i> or <i>b</i>.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> iff the collections contain the same elements with the same cardinalities.</dd></dl>
</li>
</ul>
<a name="isEqualCollection(java.util.Collection, java.util.Collection, org.apache.commons.collections4.Equator)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isEqualCollection</h4>
<pre>public static&nbsp;boolean&nbsp;isEqualCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;a,
                        <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;b,
                        <a href="../../../../org/apache/commons/collections4/Equator.html" title="interface in org.apache.commons.collections4">Equator</a>&lt;?&gt;&nbsp;equator)</pre>
<div class="block">Returns <tt>true</tt> iff the given <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a>s contain
 exactly the same elements with exactly the same cardinalities.
 <p>
 That is, iff the cardinality of <i>e</i> in <i>a</i> is
 equal to the cardinality of <i>e</i> in <i>b</i>,
 for each element <i>e</i> in <i>a</i> or <i>b</i>.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd><dd><code>equator</code> - the Equator used for testing equality</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> iff the collections contain the same elements with the same cardinalities.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the equator is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="cardinality(java.lang.Object,java.lang.Iterable)">
<!--   -->
</a><a name="cardinality(O, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>cardinality</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;int&nbsp;cardinality(O&nbsp;obj,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? super O&gt;&nbsp;coll)</pre>
<div class="block">Returns the number of occurrences of <i>obj</i> in <i>coll</i>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the type of object that the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> may contain.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>obj</code> - the object to find the cardinality of</dd><dd><code>coll</code> - the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to search</dd>
<dt><span class="strong">Returns:</span></dt><dd>the the number of occurrences of obj in coll</dd></dl>
</li>
</ul>
<a name="find(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>find</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;T&nbsp;find(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
         <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super T&gt;&nbsp;predicate)</pre>
<div class="block">Finds the first element in the given collection which matches the given predicate.
 <p>
 If the input collection or predicate is null, or no element of the collection
 matches the predicate, null is returned.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to search, may be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the first element of the collection which matches the predicate or null if none could be found</dd></dl>
</li>
</ul>
<a name="forAllDo(java.lang.Iterable,org.apache.commons.collections4.Closure)">
<!--   -->
</a><a name="forAllDo(java.lang.Iterable, C)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>forAllDo</h4>
<pre>public static&nbsp;&lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;C&nbsp;forAllDo(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
                                          C&nbsp;closure)</pre>
<div class="block">Executes the given closure on each element in the collection.
 <p>
 If the input collection or closure is null, there is no change made.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dd><code>C</code> - the closure type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to get the input from, may be null</dd><dd><code>closure</code> - the closure to perform, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>closure</dd></dl>
</li>
</ul>
<a name="forAllDo(java.util.Iterator,org.apache.commons.collections4.Closure)">
<!--   -->
</a><a name="forAllDo(java.util.Iterator, C)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>forAllDo</h4>
<pre>public static&nbsp;&lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;C&nbsp;forAllDo(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;T&gt;&nbsp;iterator,
                                          C&nbsp;closure)</pre>
<div class="block">Executes the given closure on each element in the collection.
 <p>
 If the input collection or closure is null, there is no change made.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util"><code>Iterator</code></a> contains</dd><dd><code>C</code> - the closure type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>iterator</code> - the iterator to get the input from, may be null</dd><dd><code>closure</code> - the closure to perform, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>closure</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="forAllButLastDo(java.lang.Iterable,org.apache.commons.collections4.Closure)">
<!--   -->
</a><a name="forAllButLastDo(java.lang.Iterable, C)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>forAllButLastDo</h4>
<pre>public static&nbsp;&lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;T&nbsp;forAllButLastDo(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
                                                 C&nbsp;closure)</pre>
<div class="block">Executes the given closure on each but the last element in the collection.
 <p>
 If the input collection or closure is null, there is no change made.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dd><code>C</code> - the closure type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to get the input from, may be null</dd><dd><code>closure</code> - the closure to perform, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the last element in the collection, or null if either collection or closure is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="forAllButLastDo(java.util.Iterator,org.apache.commons.collections4.Closure)">
<!--   -->
</a><a name="forAllButLastDo(java.util.Iterator, C)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>forAllButLastDo</h4>
<pre>public static&nbsp;&lt;T,C extends <a href="../../../../org/apache/commons/collections4/Closure.html" title="interface in org.apache.commons.collections4">Closure</a>&lt;? super T&gt;&gt;&nbsp;T&nbsp;forAllButLastDo(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;T&gt;&nbsp;iterator,
                                                 C&nbsp;closure)</pre>
<div class="block">Executes the given closure on each but the last element in the collection.
 <p>
 If the input collection or closure is null, there is no change made.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dd><code>C</code> - the closure type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>iterator</code> - the iterator to get the input from, may be null</dd><dd><code>closure</code> - the closure to perform, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the last element in the collection, or null if either iterator or closure is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="filter(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>filter</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;boolean&nbsp;filter(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
                 <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super T&gt;&nbsp;predicate)</pre>
<div class="block">Filter the collection by applying a Predicate to each element. If the
 predicate returns false, remove the element.
 <p>
 If the input collection or predicate is null, there is no change made.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use as a filter, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if the collection is modified by this call, false otherwise.</dd></dl>
</li>
</ul>
<a name="filterInverse(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>filterInverse</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;boolean&nbsp;filterInverse(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;collection,
                        <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super T&gt;&nbsp;predicate)</pre>
<div class="block">Filter the collection by applying a Predicate to each element. If the
 predicate returns true, remove the element.
 <p>
 This is equivalent to <pre>filter(collection, PredicateUtils.notPredicate(predicate))</pre>
 if predicate is != null.
 <p>
 If the input collection or predicate is null, there is no change made.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use as a filter, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if the collection is modified by this call, false otherwise.</dd></dl>
</li>
</ul>
<a name="transform(java.util.Collection, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>transform</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;void&nbsp;transform(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                 <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super C,? extends C&gt;&nbsp;transformer)</pre>
<div class="block">Transform the collection by applying a Transformer to each element.
 <p>
 If the input collection or transformer is null, there is no change made.
 <p>
 This routine is best for Lists, for which set() is used to do the
 transformations "in place." For other Collections, clear() and addAll()
 are used to replace elements.
 <p>
 If the input collection controls its input, such as a Set, and the
 Transformer creates duplicates (or are otherwise invalid), the collection
 may reduce in size due to calling this method.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> to get the input from, may be null</dd><dd><code>transformer</code> - the transformer to perform, may be null</dd></dl>
</li>
</ul>
<a name="countMatches(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>countMatches</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;int&nbsp;countMatches(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;C&gt;&nbsp;input,
                   <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</pre>
<div class="block">Counts the number of elements in the input collection that match the
 predicate.
 <p>
 A <code>null</code> collection or predicate matches no elements.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>input</code> - the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the number of matches for the predicate in the collection</dd></dl>
</li>
</ul>
<a name="exists(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>exists</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;boolean&nbsp;exists(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;C&gt;&nbsp;input,
                 <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</pre>
<div class="block">Answers true if a predicate is true for at least one element of a
 collection.
 <p>
 A <code>null</code> collection or predicate returns false.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>input</code> - the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if at least one element of the collection matches the predicate</dd></dl>
</li>
</ul>
<a name="matchesAll(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>matchesAll</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;boolean&nbsp;matchesAll(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;C&gt;&nbsp;input,
                     <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</pre>
<div class="block">Answers true if a predicate is true for every element of a
 collection.
 <p>
 A <code>null</code> predicate returns false.<br/>
 A <code>null</code> or empty collection returns true.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>input</code> - the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if every element of the collection matches the predicate or if the
 collection is empty, false otherwise</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="select(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>select</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;select(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
                       <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate)</pre>
<div class="block">Selects all elements from input collection which match the given
 predicate into an output collection.
 <p>
 A <code>null</code> predicate matches no elements.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputCollection</code> - the collection to get the input from, may not be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the elements matching the predicate (new list)</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the input collection is null</dd></dl>
</li>
</ul>
<a name="select(java.lang.Iterable,org.apache.commons.collections4.Predicate,java.util.Collection)">
<!--   -->
</a><a name="select(java.lang.Iterable, org.apache.commons.collections4.Predicate, R)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>select</h4>
<pre>public static&nbsp;&lt;O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;R&nbsp;select(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
                                           <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate,
                                           R&nbsp;outputCollection)</pre>
<div class="block">Selects all elements from input collection which match the given
 predicate and adds them to outputCollection.
 <p>
 If the input collection or predicate is null, there is no change to the
 output collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dd><code>R</code> - the type of the output <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a></dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputCollection</code> - the collection to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd><dd><code>outputCollection</code> - the collection to output into, may not be null if the inputCollection
   and predicate or not null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the outputCollection</dd></dl>
</li>
</ul>
<a name="selectRejected(java.lang.Iterable, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>selectRejected</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;selectRejected(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
                               <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate)</pre>
<div class="block">Selects all elements from inputCollection which don't match the given
 predicate into an output collection.
 <p>
 If the input predicate is <code>null</code>, the result is an empty
 list.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputCollection</code> - the collection to get the input from, may not be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the elements <b>not</b> matching the predicate (new list)</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the input collection is null</dd></dl>
</li>
</ul>
<a name="selectRejected(java.lang.Iterable,org.apache.commons.collections4.Predicate,java.util.Collection)">
<!--   -->
</a><a name="selectRejected(java.lang.Iterable, org.apache.commons.collections4.Predicate, R)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>selectRejected</h4>
<pre>public static&nbsp;&lt;O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;R&nbsp;selectRejected(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;inputCollection,
                                                   <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super O&gt;&nbsp;predicate,
                                                   R&nbsp;outputCollection)</pre>
<div class="block">Selects all elements from inputCollection which don't match the given
 predicate and adds them to outputCollection.
 <p>
 If the input predicate is <code>null</code>, no elements are added to
 <code>outputCollection</code>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> contains</dd><dd><code>R</code> - the type of the output <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a></dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputCollection</code> - the collection to get the input from, may be null</dd><dd><code>predicate</code> - the predicate to use, may be null</dd><dd><code>outputCollection</code> - the collection to output into, may not be null if the inputCollection
   and predicate or not null</dd>
<dt><span class="strong">Returns:</span></dt><dd>outputCollection</dd></dl>
</li>
</ul>
<a name="collect(java.lang.Iterable, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collect</h4>
<pre>public static&nbsp;&lt;I,O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;collect(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;I&gt;&nbsp;inputCollection,
                          <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer)</pre>
<div class="block">Returns a new Collection consisting of the elements of inputCollection
 transformed by the given transformer.
 <p>
 If the input transformer is null, the result is an empty list.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>I</code> - the type of object in the input collection</dd><dd><code>O</code> - the type of object in the output collection</dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputCollection</code> - the collection to get the input from, may not be null</dd><dd><code>transformer</code> - the transformer to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the transformed result (new list)</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the input collection is null</dd></dl>
</li>
</ul>
<a name="collect(java.util.Iterator, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collect</h4>
<pre>public static&nbsp;&lt;I,O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;O&gt;&nbsp;collect(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;I&gt;&nbsp;inputIterator,
                          <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer)</pre>
<div class="block">Transforms all elements from the inputIterator with the given transformer
 and adds them to the outputCollection.
 <p>
 If the input iterator or transformer is null, the result is an empty
 list.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>I</code> - the type of object in the input collection</dd><dd><code>O</code> - the type of object in the output collection</dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputIterator</code> - the iterator to get the input from, may be null</dd><dd><code>transformer</code> - the transformer to use, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the transformed result (new list)</dd></dl>
</li>
</ul>
<a name="collect(java.lang.Iterable,org.apache.commons.collections4.Transformer,java.util.Collection)">
<!--   -->
</a><a name="collect(java.lang.Iterable, org.apache.commons.collections4.Transformer, R)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collect</h4>
<pre>public static&nbsp;&lt;I,O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;R&nbsp;collect(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends I&gt;&nbsp;inputCollection,
                                              <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer,
                                              R&nbsp;outputCollection)</pre>
<div class="block">Transforms all elements from inputCollection with the given transformer
 and adds them to the outputCollection.
 <p>
 If the input collection or transformer is null, there is no change to the
 output collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>I</code> - the type of object in the input collection</dd><dd><code>O</code> - the type of object in the output collection</dd><dd><code>R</code> - the output type of the transformer - this extends O.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputCollection</code> - the collection to get the input from, may be null</dd><dd><code>transformer</code> - the transformer to use, may be null</dd><dd><code>outputCollection</code> - the collection to output into, may not be null if the inputCollection
   and transformer are not null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the outputCollection with the transformed input added</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the output collection is null and both, inputCollection and
   transformer are not null</dd></dl>
</li>
</ul>
<a name="collect(java.util.Iterator,org.apache.commons.collections4.Transformer,java.util.Collection)">
<!--   -->
</a><a name="collect(java.util.Iterator, org.apache.commons.collections4.Transformer, R)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collect</h4>
<pre>public static&nbsp;&lt;I,O,R extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? super O&gt;&gt;&nbsp;R&nbsp;collect(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;? extends I&gt;&nbsp;inputIterator,
                                              <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super I,? extends O&gt;&nbsp;transformer,
                                              R&nbsp;outputCollection)</pre>
<div class="block">Transforms all elements from the inputIterator with the given transformer
 and adds them to the outputCollection.
 <p>
 If the input iterator or transformer is null, there is no change to the
 output collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>I</code> - the type of object in the input collection</dd><dd><code>O</code> - the type of object in the output collection</dd><dd><code>R</code> - the output type of the transformer - this extends O.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>inputIterator</code> - the iterator to get the input from, may be null</dd><dd><code>transformer</code> - the transformer to use, may be null</dd><dd><code>outputCollection</code> - the collection to output into, may not be null if the inputCollection
   and transformer are not null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the outputCollection with the transformed input added</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the output collection is null and both, inputCollection and
   transformer are not null</dd></dl>
</li>
</ul>
<a name="addIgnoreNull(java.util.Collection,java.lang.Object)">
<!--   -->
</a><a name="addIgnoreNull(java.util.Collection, T)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addIgnoreNull</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;boolean&nbsp;addIgnoreNull(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;T&gt;&nbsp;collection,
                        T&nbsp;object)</pre>
<div class="block">Adds an element to the collection unless the element is null.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to add to, must not be null</dd><dd><code>object</code> - the object to add, if null it will not be added</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if the collection changed</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="addAll(java.util.Collection, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addAll</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;boolean&nbsp;addAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends C&gt;&nbsp;iterable)</pre>
<div class="block">Adds all elements in the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to the given collection. If the
 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> is a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> then it is cast and will be
 added using <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true#addAll(java.util.Collection)" title="class or interface in java.util"><code>Collection.addAll(Collection)</code></a> instead of iterating.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to add to, must not be null</dd><dd><code>iterable</code> - the iterable of elements to add, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a boolean indicating whether the collection has changed or not.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection or iterator is null</dd></dl>
</li>
</ul>
<a name="addAll(java.util.Collection, java.util.Iterator)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addAll</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;boolean&nbsp;addAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;? extends C&gt;&nbsp;iterator)</pre>
<div class="block">Adds all elements in the iteration to the given collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to add to, must not be null</dd><dd><code>iterator</code> - the iterator of elements to add, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a boolean indicating whether the collection has changed or not.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection or iterator is null</dd></dl>
</li>
</ul>
<a name="addAll(java.util.Collection, java.util.Enumeration)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addAll</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;boolean&nbsp;addAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</a>&lt;? extends C&gt;&nbsp;enumeration)</pre>
<div class="block">Adds all elements in the enumeration to the given collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to add to, must not be null</dd><dd><code>enumeration</code> - the enumeration of elements to add, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> if the collections was changed, <code>false</code> otherwise</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection or enumeration is null</dd></dl>
</li>
</ul>
<a name="addAll(java.util.Collection,java.lang.Object[])">
<!--   -->
</a><a name="addAll(java.util.Collection, C[])">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addAll</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;boolean&nbsp;addAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                 C[]&nbsp;elements)</pre>
<div class="block">Adds all elements in the array to the given collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to add to, must not be null</dd><dd><code>elements</code> - the array of elements to add, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> if the collection was changed, <code>false</code> otherwise</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection or array is null</dd></dl>
</li>
</ul>
<a name="get(java.util.Iterator, int)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>get</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;T&nbsp;get(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a>&lt;T&gt;&nbsp;iterator,
        int&nbsp;index)</pre>
<div class="block">Returns the <code>index</code>-th value in <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util"><code>Iterator</code></a>, throwing
 <code>IndexOutOfBoundsException</code> if there is no such element.
 <p>
 The Iterator is advanced to <code>index</code> (or to the end, if
 <code>index</code> exceeds the number of entries) as a side effect of this method.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object in the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util"><code>Iterator</code></a></dd><dt><span class="strong">Parameters:</span></dt><dd><code>iterator</code> - the iterator to get a value from</dd><dd><code>index</code> - the index to get</dd>
<dt><span class="strong">Returns:</span></dt><dd>the object at the specified index</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - if the index is invalid</dd>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the object type is invalid</dd></dl>
</li>
</ul>
<a name="get(java.lang.Iterable, int)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>get</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;T&nbsp;get(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;T&gt;&nbsp;iterable,
        int&nbsp;index)</pre>
<div class="block">Returns the <code>index</code>-th value in the <code>iterable</code>'s <a href="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util"><code>Iterator</code></a>, throwing
 <code>IndexOutOfBoundsException</code> if there is no such element.
 <p>
 If the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> is a <a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util"><code>List</code></a>, then it will use <a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true#get(int)" title="class or interface in java.util"><code>List.get(int)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - the type of object in the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a>.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>iterable</code> - the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a> to get a value from</dd><dd><code>index</code> - the index to get</dd>
<dt><span class="strong">Returns:</span></dt><dd>the object at the specified index</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - if the index is invalid</dd></dl>
</li>
</ul>
<a name="get(java.lang.Object, int)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>get</h4>
<pre>public static&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;get(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;object,
         int&nbsp;index)</pre>
<div class="block">Returns the <code>index</code>-th value in <code>object</code>, throwing
 <code>IndexOutOfBoundsException</code> if there is no such element or
 <code>IllegalArgumentException</code> if <code>object</code> is not an
 instance of one of the supported types.
 <p>
 The supported types, and associated semantics are:
 <ul>
 <li> Map -- the value returned is the <code>Map.Entry</code> in position
      <code>index</code> in the map's <code>entrySet</code> iterator,
      if there is such an entry.</li>
 <li> List -- this method is equivalent to the list's get method.</li>
 <li> Array -- the <code>index</code>-th array entry is returned,
      if there is such an entry; otherwise an <code>IndexOutOfBoundsException</code>
      is thrown.</li>
 <li> Collection -- the value returned is the <code>index</code>-th object
      returned by the collection's default iterator, if there is such an element.</li>
 <li> Iterator or Enumeration -- the value returned is the
      <code>index</code>-th object in the Iterator/Enumeration, if there
      is such an element.  The Iterator/Enumeration is advanced to
      <code>index</code> (or to the end, if <code>index</code> exceeds the
      number of entries) as a side effect of this method.</li>
 </ul></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>object</code> - the object to get a value from</dd><dd><code>index</code> - the index to get</dd>
<dt><span class="strong">Returns:</span></dt><dd>the object at the specified index</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - if the index is invalid</dd>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the object type is invalid</dd></dl>
</li>
</ul>
<a name="get(java.util.Map, int)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>get</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</a>&lt;K,V&gt;&nbsp;get(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                       int&nbsp;index)</pre>
<div class="block">Returns the <code>index</code>-th <code>Map.Entry</code> in the <code>map</code>'s <code>entrySet</code>,
 throwing <code>IndexOutOfBoundsException</code> if there is no such element.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type in the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a></dd><dd><code>V</code> - the key type in the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a></dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the object to get a value from</dd><dd><code>index</code> - the index to get</dd>
<dt><span class="strong">Returns:</span></dt><dd>the object at the specified index</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - if the index is invalid</dd></dl>
</li>
</ul>
<a name="size(java.lang.Object)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>size</h4>
<pre>public static&nbsp;int&nbsp;size(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;object)</pre>
<div class="block">Gets the size of the collection/iterator specified.
 <p>
 This method can handles objects as follows
 <ul>
 <li>Collection - the collection size
 <li>Map - the map size
 <li>Array - the array size
 <li>Iterator - the number of elements remaining in the iterator
 <li>Enumeration - the number of elements remaining in the enumeration
 </ul></div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>object</code> - the object to get the size of, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the size of the specified collection or 0 if the object was null</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - thrown if object is not recognised</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.1</dd></dl>
</li>
</ul>
<a name="sizeIsEmpty(java.lang.Object)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>sizeIsEmpty</h4>
<pre>public static&nbsp;boolean&nbsp;sizeIsEmpty(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;object)</pre>
<div class="block">Checks if the specified collection/array/iterator is empty.
 <p>
 This method can handles objects as follows
 <ul>
 <li>Collection - via collection isEmpty
 <li>Map - via map isEmpty
 <li>Array - using array size
 <li>Iterator - via hasNext
 <li>Enumeration - via hasMoreElements
 </ul>
 <p>
 Note: This method is named to avoid clashing with
 <a href="../../../../org/apache/commons/collections4/CollectionUtils.html#isEmpty(java.util.Collection)"><code>isEmpty(Collection)</code></a>.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>object</code> - the object to get the size of, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if empty or null</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - thrown if object is not recognised</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="isEmpty(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isEmpty</h4>
<pre>public static&nbsp;boolean&nbsp;isEmpty(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll)</pre>
<div class="block">Null-safe check if the specified collection is empty.
 <p>
 Null returns true.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>coll</code> - the collection to check, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if empty or null</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="isNotEmpty(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isNotEmpty</h4>
<pre>public static&nbsp;boolean&nbsp;isNotEmpty(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;coll)</pre>
<div class="block">Null-safe check if the specified collection is not empty.
 <p>
 Null returns false.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>coll</code> - the collection to check, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if non-null and non-empty</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="reverseArray(java.lang.Object[])">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>reverseArray</h4>
<pre>public static&nbsp;void&nbsp;reverseArray(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]&nbsp;array)</pre>
<div class="block">Reverses the order of the given array.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>array</code> - the array to reverse</dd></dl>
</li>
</ul>
<a name="isFull(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isFull</h4>
<pre>public static&nbsp;boolean&nbsp;isFull(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;coll)</pre>
<div class="block">Returns true if no more elements can be added to the Collection.
 <p>
 This method uses the <a href="../../../../org/apache/commons/collections4/BoundedCollection.html" title="interface in org.apache.commons.collections4"><code>BoundedCollection</code></a> interface to determine the
 full status. If the collection does not implement this interface then
 false is returned.
 <p>
 The collection does not have to implement this interface directly.
 If the collection has been decorated using the decorators subpackage
 then these will be removed to access the BoundedCollection.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>coll</code> - the collection to check</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if the BoundedCollection is full</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection is null</dd></dl>
</li>
</ul>
<a name="maxSize(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>maxSize</h4>
<pre>public static&nbsp;int&nbsp;maxSize(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;coll)</pre>
<div class="block">Get the maximum number of elements that the Collection can contain.
 <p>
 This method uses the <a href="../../../../org/apache/commons/collections4/BoundedCollection.html" title="interface in org.apache.commons.collections4"><code>BoundedCollection</code></a> interface to determine the
 maximum size. If the collection does not implement this interface then
 -1 is returned.
 <p>
 The collection does not have to implement this interface directly.
 If the collection has been decorated using the decorators subpackage
 then these will be removed to access the BoundedCollection.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>coll</code> - the collection to check</dd>
<dt><span class="strong">Returns:</span></dt><dd>the maximum size of the BoundedCollection, -1 if no maximum size</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the collection is null</dd></dl>
</li>
</ul>
<a name="collate(java.lang.Iterable, java.lang.Iterable)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collate</h4>
<pre>public static&nbsp;&lt;O extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a>&lt;? super O&gt;&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;&nbsp;collate(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                                                <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b)</pre>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the natural ordering of the elements is retained.
 <p>
 Uses the standard O(n) merge algorithm for combining two sorted lists.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the element type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new sorted List, containing the elements of Collection a and b</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if either collection is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="collate(java.lang.Iterable, java.lang.Iterable, boolean)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collate</h4>
<pre>public static&nbsp;&lt;O extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a>&lt;? super O&gt;&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;&nbsp;collate(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                                                <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
                                                boolean&nbsp;includeDuplicates)</pre>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the natural ordering of the elements is retained.
 <p>
 Uses the standard O(n) merge algorithm for combining two sorted lists.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the element type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd><dd><code>includeDuplicates</code> - if <code>true</code> duplicate elements will be retained, otherwise
   they will be removed in the output collection</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new sorted List, containing the elements of Collection a and b</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if either collection is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="collate(java.lang.Iterable, java.lang.Iterable, java.util.Comparator)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collate</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;&nbsp;collate(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;? super O&gt;&nbsp;c)</pre>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the ordering of the elements according to Comparator c is retained.
 <p>
 Uses the standard O(n) merge algorithm for combining two sorted lists.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the element type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd><dd><code>c</code> - the comparator to use for the merge.</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new sorted List, containing the elements of Collection a and b</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if either collection or the comparator is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="collate(java.lang.Iterable, java.lang.Iterable, java.util.Comparator, boolean)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>collate</h4>
<pre>public static&nbsp;&lt;O&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;O&gt;&nbsp;collate(<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;a,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends O&gt;&nbsp;b,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;? super O&gt;&nbsp;c,
                  boolean&nbsp;includeDuplicates)</pre>
<div class="block">Merges two sorted Collections, a and b, into a single, sorted List
 such that the ordering of the elements according to Comparator c is retained.
 <p>
 Uses the standard O(n) merge algorithm for combining two sorted lists.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>O</code> - the element type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>a</code> - the first collection, must not be null</dd><dd><code>b</code> - the second collection, must not be null</dd><dd><code>c</code> - the comparator to use for the merge.</dd><dd><code>includeDuplicates</code> - if <code>true</code> duplicate elements will be retained, otherwise
   they will be removed in the output collection</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new sorted List, containing the elements of Collection a and b</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if either collection or the comparator is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="permutations(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>permutations</h4>
<pre>public static&nbsp;&lt;E&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="http://download.oracle.com/javase/6/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;E&gt;&gt;&nbsp;permutations(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection)</pre>
<div class="block">Returns a <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> of all the permutations of the input collection.
 <p>
 NOTE: the number of permutations of a given collection is equal to n!, where
 n is the size of the collection. Thus, the resulting collection will become
 <b>very</b> large for collections &gt; 10 (e.g. 10! = 3628800, 15! = 1307674368000).
 <p>
 For larger collections it is advised to use a <a href="../../../../org/apache/commons/collections4/iterators/PermutationIterator.html" title="class in org.apache.commons.collections4.iterators"><code>PermutationIterator</code></a> to
 iterate over all permutations.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>E</code> - the element type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to create permutations for, may not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>an unordered collection of all permutations of the input collection</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if collection is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/iterators/PermutationIterator.html" title="class in org.apache.commons.collections4.iterators"><code>PermutationIterator</code></a></dd></dl>
</li>
</ul>
<a name="retainAll(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>retainAll</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;retainAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                          <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;retain)</pre>
<div class="block">Returns a collection containing all the elements in <code>collection</code>
 that are also in <code>retain</code>. The cardinality of an element <code>e</code>
 in the returned collection is the same as the cardinality of <code>e</code>
 in <code>collection</code> unless <code>retain</code> does not contain <code>e</code>, in which
 case the cardinality is zero. This method is useful if you do not wish to modify
 the collection <code>c</code> and thus cannot call <code>c.retainAll(retain);</code>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection whose contents are the target of the #retailAll operation</dd><dd><code>retain</code> - the collection containing the elements to be retained in the returned collection</dd>
<dt><span class="strong">Returns:</span></dt><dd>a <code>Collection</code> containing all the elements of <code>collection</code>
 that occur at least once in <code>retain</code>.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if either parameter is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="removeAll(java.util.Collection, java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>removeAll</h4>
<pre>public static&nbsp;&lt;E&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;removeAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection,
                          <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;?&gt;&nbsp;remove)</pre>
<div class="block">Removes the elements in <code>remove</code> from <code>collection</code>. That is, this
 method returns a collection containing all the elements in <code>c</code>
 that are not in <code>remove</code>. The cardinality of an element <code>e</code>
 in the returned collection is the same as the cardinality of <code>e</code>
 in <code>collection</code> unless <code>remove</code> contains <code>e</code>, in which
 case the cardinality is zero. This method is useful if you do not wish to modify
 the collection <code>c</code> and thus cannot call <code>collection.removeAll(remove);</code>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>E</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection from which items are removed (in the returned collection)</dd><dd><code>remove</code> - the items to be removed from the returned <code>collection</code></dd>
<dt><span class="strong">Returns:</span></dt><dd>a <code>Collection</code> containing all the elements of <code>collection</code> except
 any elements that also occur in <code>remove</code>.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if either parameter is null</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0 (method existed in 3.2 but was completely broken)</dd></dl>
</li>
</ul>
<a name="synchronizedCollection(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>synchronizedCollection</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;synchronizedCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection)</pre>
<div class="block">Returns a synchronized collection backed by the given collection.
 <p>
 You must manually synchronize on the returned buffer's iterator to
 avoid non-deterministic behavior:

 <pre>
 Collection c = CollectionUtils.synchronizedCollection(myCollection);
 synchronized (c) {
     Iterator i = c.iterator();
     while (i.hasNext()) {
         process (i.next());
     }
 }
 </pre>

 This method uses the implementation in the decorators subpackage.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to synchronize, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a synchronized collection backed by the given collection</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the collection is null</dd></dl>
</li>
</ul>
<a name="unmodifiableCollection(java.util.Collection)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>unmodifiableCollection</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;unmodifiableCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;? extends C&gt;&nbsp;collection)</pre>
<div class="block">Returns an unmodifiable collection backed by the given collection.
 <p>
 This method uses the implementation in the decorators subpackage.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to make unmodifiable, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>an unmodifiable collection backed by the given collection</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the collection is null</dd></dl>
</li>
</ul>
<a name="predicatedCollection(java.util.Collection, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>predicatedCollection</h4>
<pre>public static&nbsp;&lt;C&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;predicatedCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;C&gt;&nbsp;collection,
                                     <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super C&gt;&nbsp;predicate)</pre>
<div class="block">Returns a predicated (validating) collection backed by the given collection.
 <p>
 Only objects that pass the test in the given predicate can be added to the collection.
 Trying to add an invalid object results in an IllegalArgumentException.
 It is important not to use the original collection after invoking this method,
 as it is a backdoor for adding invalid objects.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>C</code> - the type of objects in the Collection.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to predicate, must not be null</dd><dd><code>predicate</code> - the predicate for the collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a predicated collection backed by the given collection</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Collection is null</dd></dl>
</li>
</ul>
<a name="transformingCollection(java.util.Collection, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>transformingCollection</h4>
<pre>public static&nbsp;&lt;E&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;transformingCollection(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection,
                                       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super E,? extends E&gt;&nbsp;transformer)</pre>
<div class="block">Returns a transformed bag backed by the given collection.
 <p>
 Each object is passed through the transformer as it is added to the
 Collection. It is important not to use the original collection after invoking this
 method, as it is a backdoor for adding untransformed objects.
 <p>
 Existing entries in the specified collection will not be transformed.
 If you want that behaviour, see <a href="../../../../org/apache/commons/collections4/collection/TransformedCollection.html#transformedCollection(java.util.Collection, org.apache.commons.collections4.Transformer)"><code>TransformedCollection.transformedCollection(java.util.Collection&lt;E&gt;, org.apache.commons.collections4.Transformer&lt;? super E, ? extends E&gt;)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>E</code> - the type of object the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util"><code>Collection</code></a> contains</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - the collection to predicate, must not be null</dd><dd><code>transformer</code> - the transformer for the collection, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a transformed collection backed by the given collection</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Collection or Transformer is null</dd></dl>
</li>
</ul>
<a name="extractSingleton(java.util.Collection)">
<!--   -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>extractSingleton</h4>
<pre>public static&nbsp;&lt;E&gt;&nbsp;E&nbsp;extractSingleton(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;E&gt;&nbsp;collection)</pre>
<div class="block">Extract the lone element of the specified Collection.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>E</code> - collection type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>collection</code> - to read</dd>
<dt><span class="strong">Returns:</span></dt><dd>sole member of collection</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if collection is null/empty or contains more than one element</dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar_bottom">
<!--   -->
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
<!--   -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/CollectionUtils.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../org/apache/commons/collections4/ClosureUtils.html" title="class in org.apache.commons.collections4"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../../org/apache/commons/collections4/ComparatorUtils.html" title="class in org.apache.commons.collections4"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/commons/collections4/CollectionUtils.html" target="_top">Frames</a></li>
<li><a href="CollectionUtils.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
  allClassesLink = document.getElementById("allclasses_navbar_bottom");
  if(window==top) {
    allClassesLink.style.display = "block";
  }
  else {
    allClassesLink.style.display = "none";
  }
  //-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_bottom">
<!--   -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2001&#x2013;2013 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</body>
</html>
